Template Method 
Pattern 


Tea recipe: 



Example 

Coffee recipe: 

• boil some water 

• brew coffee in 
the water 

• pour coffee in 
cup 

• add sugar and 
milk 


boil some 
water 

steep tea in 
the water 
Remove tea 
from water 
Pour cup of tea 
Add sugar, 
milk or lemon 

















public class Coffee { 



public void makeRecipe() { 
boilWater(); 
brewCoffeeGrinds(); 
pourInCup (); 
addSugarAndMilk(); 

} 

public void boilWater() { 

System.out.printin( "Boiling water" ); 

} 

public void brewCoffeeGrinds() { 

System.out.printIn( "Brewing the coffee" ); 

} 

public void pourlnCupO { 

System.out.printin ( "Pouring into cup" ); 

} 

public void addSugarAndMilk() { 

System.out.printin ( "Adding sugar, milk" ); 
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public class Tea { 



puJDiic void maKeKecipe u I 
boilWater(); 
steepTea(); 
removeTea() ; 
pourlnCup (); 
addSugarMilkLemon(); 

} 

public void boilWater() { 

S ystem.out.printIn( " Boil ing wa ter" ); 


} 

public void steepTeaBag 
System.out.println( 

} 

public void removeTea() 
System.out.println( 

} 

public void pourlnCup() 
System.out.println( 

} 


0 { 

"Steeping the tea" ); 

{ 

"Remove Tea" ); 

{ 

"Pouring into cup" ); 


} 
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Similar Algorithms 

General recipe: 

• boil some water 

• use the water to extract coffee or tea 

• pour resulting beverage into a cup 

• add appropriate condiments to the 
beverage 
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Similar Algorithms 


// in Coffee class 

public void 
makeRecipe() { 

boilWater(); 
brewCoffeeGrinds (); 
pourInCup () ; 
addSugarAndMilk (); 

} 


// in Tea class 

public void 
makeRecipe() { 

boilWater(); 
steepTeaBag () ; 
RemoveTeaBag (); 
pourInCup(); 
addSugarMilkLemon (); 


} 
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public abstract class HotCaffeineBeverage { 



template 

method 


:-fe?tp== 


// where subclasses provide certain parts 
public final void makeRecipe() { 
boilWater() ; 

brew(); // from subclass 

pourInCup(); 

addCondiments (); // from subclass 

} 

// let the subclasses determine how 

public abstract void brew(); 

public abstract void addCondiments(); 


public void boilWater() { 

System.out.println( "Boiling water" ); 

} 


public void pourlnCupO { 

System.out.printin( "Pouring into cup" ); 

} 
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// subclasses inherit 
// makeRecipe, boilWater, pourlnCup 

public class Coffee extends HotCaffeineBeverage { 

public void brew() { 

System.out.println( "Brewing the coffee" ); 

} 

public void addCondiments() { 

System.out.printin( "Adding sugar, milk" ); 

} 

} 

public class Tea extends HotCaffeineBeverage { 
public void brew() { 

System.out.println( "Steeping the tea" ); 
System.out.printin( "Removing the tea" ); 

} 

public void addCondiments() { 

System.out.printin( "Adding lemon" ); 

} 

} 
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abstract superclass 


HotCaffeineBeverage 


+ makeRecipe() 
+brew() 

+addCondimen ts () 
+ boilWater() 

+ pourInCup() 


abstract methods 
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Why Template Method? 


Before: 

Coffee and Tea have the 
algorithm 


near duplicated code in 
Coffee and Tea 


changing the algorithm 
requires opening the 
subclasses and making 
multiple changes 


After: 

HotCaffeineBeverage 
has the algorithm 


reduces duplication and 
enhances reuse 


algorithm is found in 
one place, so changes 
to it are localized 
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Why Template Method? 


Before: 

original structure 
requires more work 
to add a new 
subclass 
(need to provide 
the whole 
algorithm again) 


After: 

new structure 
provides a 
framework to add a 
new subclass (need 
to provide just the 
distinctive parts of 
the algorithm) 
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Template Method Pattern 

Design intent: 

"define the skeleton of an 
algorithm in a method, 
deferring some steps to 
subclasses" 
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Template Method Structure 
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Consequences 

Results: 

inverted control 

• superclass method calling 
subclass method 


"Hollywood principle" 

• "Don't call us, we'll call you. 
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"Hooks” 

Idea: 

methods in the superclass which provide 
default behavior that the subclasses may 
override 


often hook methods do nothing by default 
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"Hooks" 


public abstract class AbstractClass { 

public final void templateMethod() { 

primitiveOperationl(); 
primitiveOperation2(); 
hook () ; 

} 


//subclasses mustoverride 

public abstract void primitiveOperationl(); 
public abstract void primitiveOperation2(); 

// do nothing by default; 

// subclass may override 
public void hook() { } 

} 



Exercise 


Problem: 

page object to be printed 

customize for different header and footer 

common body text 

optional watermark 


public abstract class Page { 



// template method _ 

public final void print() { 

printHeader(); 
printBody(); 
printFooter(); 
printWatermark(); 

} 

// subclasses must provide header and footer 
Dublic abstract void printHeader(); 

Dublic abstract void printFooter(); 


77print the page body 
public void printBody() { 


// do nothing by default, i.e., no watermark 
public void printWatermark() { } 
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public class DraftPage extends Page { 



// print the page header 
public void printHeader() { 

} 

// print the page footer 
public void printFooter() { 

} 

public void printWatermark() { 

// print a DRAFT watermark 

} 
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Factory Method 
Pattern 


Dealing with new 

// limited, what if new pizza types? 

PepperoniPizza pizza = new PepperoniPizza(); 

// code to bake, cut, box PepperoniPizza 

// or have subclasses of a Pizza abstract superclass 
if (pizzaType.equals( "pepperoni" ) { 

Pizza pizza = new PepperoniPizza(); 

} else if (pizzaType.equals( "veggie" ) { 

Pizza pizza = new VeggiePizza() ; 

} 

// code to bake, cut, box Pizza 


Should depend upon abstractions , 
not directly upon concrete classes. 
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Attempt 1 


// general pizza ordering method 
public Pizza orderPizza() { 

Pizza pizza = new Pizza (); 

pizza.bake(); 
pizza.cut () ; 
pizza.box () ; 

return pizza; 

} 


for flexibility , 
would like to use 
the superclass name 
here , but it is 
abstract 
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Attempt 2 


// general pizza ordering method 
public Pizza orderPizza( Pizza pizza ) { 


pizza.bake(); 
pizza.cut(); 
pizza.box(); 


still need code somewhere 
to instantiate a specific 
type of pizza , and pass it in 


} 


return pizza; 
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Attempt 3 

// general pizza ordering method 
public Pizza orderPizza( String pizzaType ) { 

Pizza pizza; 


} 


if (pizzaType.equals( "pepperoni" ) { 

Pizza pizza = new PepperoniPizza(); 

} else if (pizzaType.equals( "veggie" ) { 

Pizza pizza = new VeggiePizza(); 


} 

pizza.bake(); 
pizza.cut(); 
pizza.box(); 

return pizza; 



Attempt 3 with Changes 

// general pizza ordering method 

public Pizza orderPizza( String pizzaType ) { 

Pizza pizza; 


tends to 
change 


tends to 
stay the 
same 


if (pizzaType.equals( "pepperoni" ) { 

Pizza pizza = new PepperoniPizza(); 

} else if (pizzaType.equals( "veggie" ) { 

Pizza pizza = new VeggiePizza(); 

} else if (pizzaType.equals( "hawaiian" ) { 

Pizza pizza = new HawaiianPizza(); 

} 


pizza.bake(); 
pizza.cut(); 
pizza.box(); 


} 


return pizza; 




Simple Factory Approach 


// separate factory class to create a Pizza 

public class SimplePizzaFactory { 

public Pizza createPizza ( String pizzaType ) { 

Pizza pizza = null; 

if (pizzaType.equals( "pepperoni" ) { 

Pizza pizza = new PepperoniPizza(); 

} else if (pizzaType.equals( "veggie" ) { 

Pizza pizza = new VeggiePizza() ; 

} 


} 


return pizza; 
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Using a Factory Object 

public class PizzaStore { 

private SimplePizzaFactory factory; 

public PizzaStore ( SimplePizzaFactory factory ) { 

this.factory = factory; 

} 


public Pizza orderPizza( String pizzaType ) { 

Pizza pizza; 


pizza = factory.createPizza( pizzaType ); 


pizza.bake(); 
pizza.cut (); 
pizza.box(); 

return pizza; 

} 

} 
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Factories 
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Using Factories 

PizzaStore newYorkStore = new PizzaStore ( 
new NewYorkPizzaFactory() 

); 

newYorkStore.order( "veggie" ); 


PizzaStore chicagoStore = new PizzaStore( 
new ChicagoPizzaFactory () 

); 

chicagoStore.order( "veggie" ); 



Factory Method Approach 

public abstract class PizzaStore { 

public Pizza orderPizza( String pizzaType ) { 

Pizza pizza; 


keep 

orderPizza 
general 
and 

decoupled 
from specific 
pizza types 


pizza = createPizza ( pizzaType ); 


pizza.bake(); 
pizza.cut (); 
pizza.box(); 

return pizza; 


} 


// defer to subclass to instantiate 
// Pizza of the appropriate type 
public abstract Pizza createPizza( 
String pizzaType ); 


factory 

method 


} 
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Factory Method Approach 

public class NewYorkStylePizzaStore 
extends PizzaStore { 

public Pizza createPizza ( String pizzaType ) { 

if (pizzaType.equals( "pepperoni" ) { 

Pizza pizza = 

new NewYorkStylePepperoniPizza () ; 

} else if (pizzaType.equals ( "veggie" ) { 

Pizza pizza = 

new NewYorkStyleVeggiePizza () ; 

} 

return pizza; 

} 

} 


68 


Factory Method Pattern 

Design intent: 

"define an interface for creating an object, but lets 
subclasses decide which actual class to instantiate" 


abstract Product factoryMethod ( String type ); 


decouple client code in the superclass from the object 
creation code in the subclass 
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Exercise 


Problem: 

designing a framework 

• Application and Document superclasses 
an actual application would subclass these 

• add MyApplication and MyDocument subclasses 

• but do not change the code of the superclasses 

write a general NewDocument method in Application that 
ultimately instantiates a MyDocument 
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Example Structure 

Product Creator 



factory method 


also known as Virtual Constructor 
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